DOC Skip to main content
Documentation
>
Orbbec Gemini 330 Series Documentation
>
ROS1 Tutorial Use Multiple Cameras
Orbbec Gemini 330 Series Documentation

ROS1 Tutorial Use Multiple Cameras

Update on 2025-07-25 09:36:25

This section describes how to configure and use multiple Orbbec cameras simultaneously in a ROS 1 environment.

1. Identify Camera USB Ports

Script to List Connected Cameras

To determine which USB ports the cameras are connected to, you can use the following bash script. This script lists all Orbbec devices attached to the system along with their USB port and serial number.

#!/bin/bash

VID="2bc5"

for dev in /sys/bus/usb/devices/*; do
  if [ -e "$dev/idVendor" ]; then
    vid=$(cat "$dev/idVendor")
    if [ "$vid" == "${VID}" ]; then
      port=$(basename $dev)
      product=$(cat "$dev/product" 2>/dev/null) # product name
      serial=$(cat "$dev/serial" 2>/dev/null) # serial number
      echo "Found Orbbec device $product, usb port $port, serial number $serial"
    fi
  fi
done

Save this script to a file and execute it in your terminal to output a list of connected cameras.
Or you can run the following command to list all connected Orbbec cameras:

rosrun orbbec_camera list_ob_devices.sh

2. Launch Multiple Cameras

Setup for Multiple Camera Launch

You can launch multiple cameras by specifying different USB ports for each camera. Below is an example XML file that uses the ROS 1 launch system to start two cameras with individual configurations.

<launch>
    <include file="$(find orbbec_camera)/launch/gemini_330_series.launch">
        <arg name="camera_name" value="camera_01"/>
        <arg name="usb_port" value="2-3.4.4.4.1"/>
        <arg name="device_num" value="2"/>
        <arg name="sync_mode" value="free_run"/>
    </include>

    <include file="$(find orbbec_camera)/launch/gemini_330_series.launch">
        <arg name="camera_name" value="camera_02"/>
        <arg name="usb_port" value="2-3.4.4.4.3"/>
        <arg name="device_num" value="2"/>
        <arg name="sync_mode" value="free_run"/>
    </include>
</launch>

Run the Launch File

To execute the launch configuration for multiple cameras, use the command:

roslaunch orbbec_camera multi_camera.launch

3. Configure the TF Tree for Multiple Cameras

Example TF Configuration for Two Cameras

When using multiple cameras, it’s essential to calibrate them and publish a static TF tree for each camera. The following ROS 1 XML launch configuration sets up the TF tree based on your calibration results:

<launch>
    <node pkg="tf" type="static_transform_publisher" name="camera_01_tf" args="0 0 0 0 0 0 base_link camera_01_link" />
    <node pkg="tf" type="static_transform_publisher" name="camera_02_tf" args="0 0 0 0 0 0 base_link camera_02_link" />
</launch>

Save this configuration as multi_camera_tf.launch in the launch directory of the Orbbec camera package. To run it, use:

roslaunch orbbec_camera multi_camera_tf.launch

ON THIS PAGE

Add

  • Name：

  • Link Address：

Cancel

Add

  • Name：

  • Link Address：

Cancel
Questions or
Feedback?

Feedback

  • Your feedback matters! Share your thoughts on this page, report errors, or let us know how we can improve to better support your needs. If applicable, please include the specific sentence or section to help us identify and address the issue.

@2025 0rbbec Inc. All Rights Reserved.

Stay Updated

Be the first to learn about our new products and updates.

Back to top